home *** CD-ROM | disk | FTP | other *** search
/ MPEG Toolkit / MPEG Toolkit.iso / dos / infompeg / infompeg.doc < prev    next >
Text File  |  1997-01-01  |  4KB  |  90 lines
  1. InfoMPEG version 1.0
  2. --------------------
  3.  
  4.     InfoMPEG is a small utility to parse MPEG-1 compatible video streams,
  5. and return information that is easily attainable (virtually no processing
  6. of data beyond start codes).  Even so, hopefully some will find this program
  7. useful.  Since there is very little data processing required for the
  8. program's execution, it runs fairly quickly.
  9.     InfoMPEG was written to provide a quick and convenient way of constructing
  10. charts containing various details on MPEG streams, allowing comparisons to
  11. easily be made.  It can also be used simply to find out the pixel resolution
  12. and types of frames in a stream (can do so almost instantly).
  13.  
  14.  
  15. Installing InfoMPEG
  16. -------------------
  17.  
  18. For UNIX, simply type 'make'.
  19. (If a problem arises, please email me with details of the problem.)
  20.  
  21. For any non-UNIX system, use a C compiler to compile the source file
  22. 'infoMPEG.c' included in the archive.  The code should be general enough
  23. to compile correctly under any compiler.  However, it has only been tested
  24. on a PC with Borland C for MSDOS, so please do not be surprised if the
  25. code does not compile using something else.
  26. (If you encounter a problem compiling, and email me with details of
  27.  the problem, I will try to correct it.)
  28.  
  29. For PC users, an 8086/8088 binary compatible MSDOS executable has been
  30. included in the archive which is at your disposal.  However, if you wish
  31. to recompile, you may do so with the source code included.
  32. For those using Borland C,
  33.    Copy the file 'makefile.bc' to 'makefile', and type 'make'.
  34.                    OR
  35.    Uncomment the line '#define BORLAND' near the beginning of the
  36.    header file 'infoMPEG.h', and compile within the Borland editor.
  37.  
  38.  
  39. InfoMPEG Options
  40. ----------------
  41.  
  42. Usage: InfoMPEG [-123] filename.mpg [filename.mpg ...]
  43.  
  44. Option '-1' should be used when the resolution and types of frames
  45.         in a bitstream are sufficient data.  This option is
  46.         very quick (can be used to scan through directories of
  47.         MPEG files in seconds using the wildcard string '*.MPG')
  48.  
  49. Option '-2' or Option '-3' should be used when '-1' does not return
  50.         enough data.  As with '-1', either option can be used on
  51.         a single MPEG file or with multiple files.  If more than
  52.         one file is specified, a summary chart will be displayed
  53.         at the end of output.
  54.  
  55.  
  56. Misc
  57. ----
  58.  
  59. The variable 'tot_len' is defined as an unsigned long, so it can hold
  60. values between 0 and 2^32(approx. 4 gigs).  Since this variable is
  61. used to hold the total number of bytes of uncompressed MPEG data, it
  62. is possible for it to overflow.  For example, my moderately sized MPEG
  63. collection with about two dozen streams totals just under a gigabyte
  64. uncompressed.  If this 4 gig limit is found to be too small, it will be
  65. changed.
  66.  
  67. There are a few more details readily available from a MPEG bitstream
  68. located just after the sequence start code, such as aspect ratio,
  69. frame rate, and bit rate.  Also, the number of macroblocks for each frame
  70. can easily be calculated.  There were left out because I rarely want
  71. to know their values, and I assume others would not either.
  72. However, if there are a few requests they will be included in Option '-3'.
  73.  
  74. For those who might want to know, the source code for InfoMPEG was
  75. written in two days.
  76.  
  77.  
  78. Distributing InfoMPEG
  79. ---------------------
  80.  
  81. Permission to use, copy, modify, and distribute this software and its
  82. documentation for any purpose, without fee, and without written agreement
  83. is hereby granted, provided that the following copyright notice appears
  84. in all copies of this software.
  85.  
  86. InfoMPEG Copyright (C) 1993 Dennis Lee
  87.  
  88. I welcome any comments, suggestions, and even criticism 8).
  89. Send any to email address: leed@ugsparc10.eecg.toronto.edu
  90.